home *** CD-ROM | disk | FTP | other *** search
/ Aminet 47 / Aminet 47 (2002)(GTI - Schatztruhe)[Feb 2002].iso / Aminet / misc / math / acalc.lha / acalcenglish.doc < prev    next >
Text File  |  2001-11-24  |  12KB  |  306 lines
  1.  
  2.  
  3.                              ACalc - User's Manual
  4.  
  5.  
  6.  
  7.  
  8.  
  9. AboutThisDoc
  10.  
  11.           This manual describes  release  1.50  of  the  utility  ACalc.  This
  12.   program is Copyrigth ©2001  by  Denis  GOUNELLE.  Any  commercial  usage  or
  13.   selling without author's written authorization is  strictly  forbidden.  You
  14.   can copy and spread this program at the following conditions:
  15.  
  16.         - all the files must provided
  17.         - none of the files must have been modified, in any way
  18.         - you don't charge more than $6 for copy fee
  19.  
  20.           In spite of several tests, no  warranty  is  made  that  there's  no
  21.   errors in ACalc. YOU USE THIS PROGRAM AT YOUR OWN RISK. In no event  will  I
  22.   be liable for any damage, direct or indirect, resulting of the use of ACalc.
  23.  
  24. Introduction
  25.  
  26.           ACalc is a calculator that may be used both in floating  point  mode
  27.   (double precision IEEE) and in based mode (decimal or hexadecimal).  It  may
  28.   appear on any screen, and can be installed as  a  commodity  with  Kickstart
  29.   2.04 or greater.
  30.  
  31.           Criticisms and suggestions will always be welcomed. Write to:
  32.  
  33.                                M. GOUNELLE Denis
  34.                               27, rue Jules GUESDE
  35.                             45400 FLEURY-LES-AUBRAIS
  36.                                      FRANCE
  37.  
  38.                            denis.gounelle@wanadoo.fr
  39.               http://perso.wanadoo.fr/denis.gounelle/index_e.html
  40.  
  41.   Thanks to Stéphane "SADA" Anquetil for the icon.
  42.  
  43. Installation
  44.  
  45.           Use the Installer script included in the archive.
  46.  
  47.           ACalc needs the  "mathieeedoubbas.library"  library,  which  may  be
  48.   found on system disks provided with your Amiga. Under  Kickstart  1.3,  just
  49.   copy the program in a directory included in your path (e.g. "C:").
  50.  
  51.           Under Kickstart 2.04 or greater, you may want to install ACalc as  a
  52.   commodity, and copy it in the "SYS:WBStartup" directory.
  53.  
  54.           If you want to use the Euro convertor, you have to  set  the  "EURO"
  55.   environment variable to the change rate between  your  locale  currency  and
  56.   Euro. As an example, the rate is "6.55957" for French Franc.
  57.  
  58.  
  59.  
  60. Running_from_CLI
  61.  
  62.   ACalc detach itself from CLI. Command line arguments may be:
  63.  
  64.       CX_PRIORITY n (ignored under Kickstart 1.3)
  65.           Set the commodity priority.
  66.  
  67.       CX_HOTKEY key (ignored under Kickstart 1.3)
  68.           Set the commodity hotkey. Default key is "ctrl esc".
  69.  
  70.       CX_POPUP
  71.           Opens the window at startup time.
  72.  
  73.       NOCOMM (ignored under Kickstart 1.3)
  74.           Prevent ACalc to install itself as a commodity. The program will
  75.           terminate as soon as you click on the close gadget.
  76.  
  77.       SAVEVAR
  78.           Ask  ACalc  to  save  expression  results  in  an  environnement
  79.           variable,  instead  of  the  clipboard.  The  variable  name  is
  80.           "ACalcResult".
  81.  
  82.       REXXPORT
  83.           Name of the AREXX port. Default name is "ACalc."
  84.  
  85.       PUBSCREEN
  86.           Name of the public screen to use.  By  default,  ACalc  use  the
  87.           front-most screen.
  88.  
  89.       LOCALECUR
  90.           Name or symbol of your locale currency, for the Euro conversion.
  91.           Only the 3 first characters are used. Default value is "FRF".
  92.  
  93. Running_from_Workbench
  94.  
  95.   The following arguments may be specified in the "TOOL TYPES" of ACalc  icon:
  96.  
  97.       CX_PRIORITY=n (ignored under Kickstart 1.3)
  98.           Set the commodity priority.
  99.  
  100.       CX_HOTKEY=key (ignored under Kickstart 1.3)
  101.           Set the commodity hotkey. Default key is "ctrl esc".
  102.  
  103.       CX_POPUP
  104.           Opens the window at startup time.
  105.  
  106.       NOCOMM (ignored under Kickstart 1.3)
  107.           Prevent ACalc to install itself as a commodity. The program will
  108.           terminate as soon as you click on the close gadget.
  109.  
  110.       SAVEVAR
  111.           Ask  ACalc  to  save  expression  results  in  an  environnement
  112.           variable,  instead  of  the  clipboard.  The  variable  name  is
  113.           "ACalcResult".
  114.  
  115.       REXXPORT
  116.           Name of the AREXX port. Default name is "ACalc."
  117.  
  118.       PUBSCREEN
  119.           Name of the public screen to use.  By  default,  ACalc  use  the
  120.           front-most screen.
  121.  
  122.       LOCALECUR
  123.           Name or symbol of your locale currency, for the Euro conversion.
  124.           Only the 3 first characters are used. Default value is "FRF".
  125.  
  126. Using_ACalc
  127.  
  128.           When called, ACalc opens a window  on  the  frontmost  screen.  This
  129.   window has a display area, and a 36 keys keyboard. Most of  these  keys  are
  130.   self-explanatory, so this section only describe some of them.
  131.  
  132.       Mode key (FLT,DEC,HEX)
  133.           ACalc has three working modes: floating point mode (FLT),  based
  134.           decimal mode (DEC) and based hexadecimal mode (HEX). In the  two
  135.           based modes, ACalc use 32 bits unsigned integers.  Depending  on
  136.           the current mode, some keys may be disabled.
  137.  
  138.       EUR
  139.           In FLT mode, activates the conversion from your locale  currency
  140.           to the Euro currency.
  141.  
  142.           Note: if the EURO environment variable isn't defined,  you  will
  143.           get an error message (see the "Installation" section).
  144.  
  145.       FRF
  146.           In FLT mode, activates the conversion from Euro to  your  locale
  147.           currency.
  148.  
  149.           Note: if the EURO environment variable isn't defined,  you  will
  150.           get an error message (see the "Installation" section).
  151.  
  152.           Note: the default text for this key is "FRF", but  this  can  be
  153.           changed with the LOCALECUR argument.
  154.  
  155.       d
  156.           In HEX mode, allow to  specify  that  the  immediatly  following
  157.           number is a decimal number.
  158.  
  159.       h
  160.           In DEC mode, allow to  specify  that  the  immediatly  following
  161.           number is a hexdecimal number.
  162.  
  163.       STO
  164.           This key allow to store the currently displayed result in one of
  165.           the 10 available memories. After having selected this key, click
  166.           on one of the digits (0 - 9) to select the memory number.
  167.           The memories are set to zero when the program start. If ACalc is
  168.           installed as a commodity, memory contents is  preserved  between
  169.           two invocations of the program.
  170.  
  171.       RCL
  172.           Recall the content of a memory. After having selected this  key,
  173.           click on one of the digits (0 - 9) to select the memory  number.
  174.  
  175.       BS
  176.           Delete the last character of the displayed expression or result.
  177.  
  178.       =
  179.           Start the evaluation of the  current  expression,  and  displays
  180.           either the result or an error message. In both  cases,  you  may
  181.           recall the expression by pressing the right mouse button.
  182.           The result may be immediatly used: if you click on  an  operator
  183.           (e.g. "+") ACalc will suppose  that  the  result  is  the  first
  184.           operand. Otherwise, the result will  be  deleted  because  ACalc
  185.           will suppose you want to compute a new expression.
  186.  
  187.           Each time an expression is evaluated, it's result  is  automatically
  188.   saved in the clipboard. This allow you to use this  result  in  any  program
  189.   that also use the clipboard (like your word processor  or,  under  Kickstart
  190.   2.04 or greater, the Shell window if the "conclip" program is running).
  191.           If you want to have the result saved in an  environnement  variable,
  192.   rather than the clipboard, you must call ACalc with the  "SAVEVAR"  argument
  193.   (see "Running_from_CLI" and "Running_from_Workbench" sections).
  194.  
  195. Using_the_keybord
  196.  
  197.           You can use ACalc not only with  your  mouse,  but  also  with  your
  198.   keyboard. If you want to use the keyboard,  you  can  either  click  on  the
  199.   display area and edit the expression as in any string gadget, or just  press
  200.   the key of your keyboard corresponding to the window's key  label.  In  this
  201.   case, you may also close ACalc window by pressing the "ESC" key.
  202.           Some operators are to be entered and displayed in a different manner
  203.   (not as the key label): for example, the "NOT" operator is displayed as  '~'
  204.   (tilde). If you use ACalc with the keyboard, you must press the '~' key, and
  205.   not the 'N', 'O' and 'T'  keys.  Here  is  how  you  must  enter  the  other
  206.   operators:
  207.  
  208.           mode                            TAB key
  209.           NOT                             ~
  210.           AND                             &
  211.           OR                              |
  212.           SHL                             <
  213.           SHR                             >
  214.           RCL                             M (followed by memory number)
  215.           BS                              BACKSPACE key
  216.           convert in Euros                d (FLT mode)
  217.           convert in locale currency      h (FLT mode)
  218.  
  219.   The STO and CLR keys cannot be selected with the keybord.
  220.  
  221. The_AREXX_Port
  222.  
  223.           ACalc now has an AREXX port, which name  can  be  specified  by  the
  224.   REXXPORT argument. Any string sent to this port will be taken in account  as
  225.   if each character of the string has been entered  with  the  keyboard.  This
  226.   means that the string must be terminated by a "=" in order  to  compute  the
  227.   result of the expression. The result  is  then  available  in  the  standard
  228.   RESULT variable. Here is a sample script :
  229.  
  230.           /* AREXX */
  231.  
  232.           OPTIONS RESULTS
  233.           ADDRESS "ACalc"
  234.           "35/7.2635="
  235.           valeur = RESULT
  236.           SAY valeur
  237.  
  238.           As AREXX features a builtin expression evaluator,  the  most  useful
  239.   usage of ACalc AREXX port is the Euro conversion:
  240.  
  241.           /* AREXX */
  242.  
  243.           OPTIONS RESULTS
  244.           PARSE UPPER ARG montant
  245.           ADDRESS "ACalc"
  246.           /* convert local currency into Euros */
  247.           montant || "d"
  248.           valeur = RESULT
  249.           SAY "Amount in Euros:" valeur
  250.           /* convert Euros into local currency */
  251.           montant || "h"
  252.           valeur = RESULT
  253.           SAY montant "Euros make" valeur
  254.  
  255.           The AREXX port name can be specified with the REXXPORT argument
  256.  
  257. History
  258.  
  259.   v1.00   15-Avr-93, 19904 bytes
  260.           o First released version.
  261.  
  262.   v1.01   26-May-93, 20140 bytes
  263.           o  Bug  fixed:  display  wasn't  good  if  the   screen   font   was
  264.             proportionnal
  265.  
  266.   v1.02   29-May-93, 20148 bytes
  267.           o Supports the "Show" command of the "Exchange" program
  268.  
  269.   v1.10   07-Jun-93, 21012 bytes
  270.           o Tries to open the window under the mouse pointer
  271.           o Better support of fonts: use the default text font for the window,
  272.             and the screen font for string gadget and window's title.
  273.           o If ACalc is installed as a commodity, running  it  twice  make  it
  274.             appeared instead of terminate.
  275.  
  276.   v1.20   29-Jun-93, 20924 bytes
  277.           o Modified gadget handling, in order  that  enabling/disabling  them
  278.             when changing working mode is faster  (was  terribly  slow  on  an
  279.             A500/A2000)
  280.  
  281.   v1.21   12-Sep-93, 20864 bytes
  282.           o Uses new version of the GetDefaultTextFont() function
  283.  
  284.   v1.30   29-Oct-93, 21012 bytes
  285.           o Read and execute messages from the "Exchange"  program  even  when
  286.             the window is opened
  287.           o If you try to wakeup the program twice, the window  will  come  in
  288.             front of all windows
  289.           o The window now correctly opens under the mouse  pointer,  even  if
  290.             the screen is bigger than the display size (take mouse position in
  291.             the Screen structure, instead of the IntuitionBase structure)
  292.  
  293.   v1.31   30-Dec-93, 20148 bytes
  294.           o Added CX_POPUP argument
  295.           o Compiled with SAS/C 6.50
  296.  
  297.   v1.40   02-Sep-01, 21680 bytes
  298.           o Added Euro convertion
  299.           o Compiled with SAS/C 6.58
  300.  
  301.   v1.50   11-Nov-01, 23304 bytes
  302.           o Added rounding to Euro conversion
  303.           o Added the AREXX port
  304.           o Added the PUBSCREEN argument
  305.           o Added an Installer script
  306.